home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / patch_up / _40xptch / nip318 / nip318.txt < prev    next >
Text File  |  1995-06-29  |  21KB  |  539 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. TITLE:    NIP318.EXE; NetWare/IP 1.1 Maintenance
  4. README FOR:  NIP318.EXE
  5.  
  6. NOVELL PRODUCTS and VERSIONS:
  7. NetWare/IP 1.1
  8.  
  9. ABSTRACT:
  10.  
  11. NIP318.EXE contains a patch for NetWare/IP 1.1 (for NetWare 3.12
  12. and 4.02 servers ONLY).  Includes both fixes and enhancements
  13. including support for new parameters. NIP318 is strongly
  14. recommended for all NetWare/IP 1.1 sites with NetWare 3.12 and
  15. NetWare 4.02, and supersedes all previous patches to NetWare/IP
  16. 1.1 for NetWare 3.12 and NetWare 4.02, including special compiled
  17. versions.
  18.  
  19.  
  20.  
  21. -----------------------------------------------------------------
  22.  DISCLAIMER
  23.  THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO
  24. NOVELL.  NOVELL
  25.  MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. 
  26. HOWEVER, THE
  27.  INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION
  28. ONLY.  NOVELL
  29.  MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS
  30. INFORMATION.
  31.  
  32. -----------------------------------------------------------------
  33.  
  34.  
  35. SYMPTOM:
  36.  
  37. 1. Server crash due to memory corruption.
  38.  
  39.  2. Badly formatted output for "stat", etc., when running on
  40. NetWare 3.12.
  41.  
  42.  3. Hanging with NetWare 3.12 on a NetFrame machine.
  43.  
  44.  4. Not showing all RIPs and SAPs.
  45.  
  46.  5. Client received network errors and was unable to login to
  47. servers.
  48.  
  49.  6. On a heavily loaded machine, NWIP/IPX gateway could not
  50. resolve SAP/RIP information for NWIP client. 
  51.  
  52.  7. Server abends resulting from truncated DNS packets.
  53.  
  54.  8. NWIP client unable to get a NWIP parameter over a slow link.
  55.  
  56.  9. Cache timeouts.
  57.  
  58.  10. Server hangs while unloading NAMED.NLM.
  59.  
  60.  11.  Failure to create an accurate replica database (a local
  61. copy of the zone database imported from the master/primary DNS
  62. server), an invalid response to Start of Authority (SOA) and Name
  63. Server (NS) queries.
  64.  
  65.  12. If SAPs were received at too fast a rate, some where
  66. dropped.
  67.  
  68.  13. When NetWare DNS was a DNS replica, unexpected responses
  69. from the master, resulted in repeated queries leading to a
  70. timeout.
  71.  
  72. SOLUTION: 
  73.  
  74. - Apply NIP318.EXE as described below.
  75.  
  76.  - In addition, for symptom number 11, update the Domain Name
  77. Server.
  78.  
  79.  To Update the Domain Name Server
  80.  --------------------------------
  81.  The NAMED.NLM included in NIP318.EXE contains a fix for servers
  82. that use the old NAMED.NLM that came with NFS Gateway 1.1/1.2 and
  83. NetWare/IP 1.1.  Therefore, Domain Name only requires updating on
  84. servers that use the NAMED.NLM replica function.
  85.  
  86.  1. After installing NIP318.EXE according to the directions
  87. below, do ONE of the following:
  88.  
  89.  -- A. Manually delete the zone database file on the DNS replica
  90. servers.  To locate the zone database file on the servers, search
  91. for the entry that begins with the keyword "secondary" in
  92. SYS:ETC/NAMED.CFG.  After you delete the zone database file, load
  93. the new NAMED.NLM.
  94.  
  95.  For example, in the entry:  SECONDARY FOO.COM
  96. 1.2.3.SYS:ETC/DNS/ZONE.DB
  97.  the zone database file is ZONE.DB.
  98.  Then go to the SYS:ETC/DNS/ directory and delete ZONE.DB.
  99.  
  100.  -- B. Manually edit the serial number field in the SOA record
  101. for the zone at the master name server to increment the number by
  102. one digit. To locate the file to edit, search for the entry that
  103. begins with the keyword "primary" in the SYS:ETC/NAMED.CFG file.
  104.  
  105. Self-Extracting File Name: nip318.exe
  106.  
  107. Files Included     Size     Date      Time
  108.  
  109. ..\
  110.       NIP318.TXT     (This file)
  111. ..\NWIP1\
  112.      PCONFIG.DAT             950         4-21-95     11:00:42 am
  113.      PCONFIG.HLP            2183         7-29-92      1:27:20 pm
  114.      PCONFIG.NLM           15934         9-17-93      6:03:06 pm
  115.       PFILES.DAT            2589         5-26-95      1:56:52 pm
  116.     PINSTALL.HLP            6798         6-21-93      2:53:24 pm
  117.     PINSTALL.NLM          132824         3-21-94     11:45:58 am
  118.     P_UNINST.HLP             892         7-27-92     12:02:08 pm
  119.     P_UNINST.NLM           72042         11-8-93      6:40:06 pm
  120.        SPACE.DAT              10          2-1-93      3:58:28 pm
  121. ..\NWIP1\PUBLIC\
  122.      NWIPMAP.E11          140433         9-28-93      2:30:42 pm
  123.      NWIPMAP.EXE          288277         3-21-95      8:07:18 pm
  124. ..\NWIP1\PUBLIC\NLS\
  125.     1252_UNI.001             727         5-31-94     11:39:46 am
  126.      437_UNI.001             727          4-4-94     11:22:20 am
  127.      850_UNI.001             727          4-4-94     11:22:24 am
  128.     UNI_1252.001            2264         5-31-94     11:39:48 am
  129.      UNI_437.001            2904          4-4-94     11:22:24 am
  130.      UNI_850.001            2776          4-4-94     11:22:28 am
  131.      UNI_COL.001            1752          4-4-94     11:22:18 am
  132.      UNI_MON.001            4312          4-4-94     11:22:18 am
  133. ..\NWIP1\PUBLIC\NLS\ENGLISH\
  134.      NWIPMAP.M11            3401         8-24-93      3:58:18 pm
  135.      NWIPMAP.MSG            7821         8-24-93      3:58:18 pm
  136. ..\NWIP1\PUBLIC\NLS\NWIP11\
  137.     1252_UNI.001             745         1-26-93      5:10:24 pm
  138.      437_UNI.001             818         1-26-93      4:57:46 pm
  139.      850_UNI.001             837         1-26-93      4:57:56 pm
  140.     UNI_1252.001             733         1-26-93      5:10:32 pm
  141.      UNI_437.001             977         1-26-93      4:57:56 pm
  142.      UNI_850.001             906         1-26-93      4:58:06 pm
  143.      UNI_COL.001            1063         1-23-93      2:24:24 pm
  144.      UNI_MON.001            1406         1-23-93      2:23:46 pm
  145. ..\NWIP1\SYSTEM\
  146.          DSS.NLM           92553         3-25-95     11:01:22 am
  147.        NAMED.NLM           52092         5-26-95      3:43:02 pm
  148.        NETDB.NLM           57940          3-8-94      2:25:02 pm
  149.         NWIP.NLM          124044         5-12-95      6:35:38 pm
  150.      NWIPADM.HLP           10796         4-19-95      4:12:48 pm
  151.      NWIPADM.NLM           53338         4-27-95     12:04:20 pm
  152.      NWIPAGT.NLM           10625         4-20-95      6:44:28 pm
  153.  
  154.  
  155. Installation Instructions:
  156.  
  157. CAUTION: Do not delete all of the original NWIP 1.1 software from
  158. the server.  NIP318 replaces only some of the NWIP1.1 files.
  159.  
  160.  1. Backup your current NetWare/IP files.
  161.  
  162.  2. At a the console of a server that already has NetWare/IP 1.1
  163. installed,
  164.  create a new directory named NIP318 on any valid NetWare volume.
  165.  MD NIP318
  166.  
  167.  3. Copy NIP318.EXE into the new directory.
  168.  
  169.  4. Type NIP318 <enter> to extract the files.
  170.  
  171.  5. From the server console, activate the installation program by
  172. typing:  LOAD INSTALL  <enter>
  173.  
  174.  6. Select PRODUCT OPTIONS.
  175.  The Currently Installed Products Menu appears and lists the
  176. following
  177.  products:
  178.      NWIP    1.1    NetWare/IP
  179.      NWUPD   1.1B   PTF-F191 NetWare/IP Patch
  180.  
  181.  The NWUPD entry will only appear in the list if you have
  182. previously applied the NIP191 patch.
  183.  
  184.  7. If the NWUPD entry appears, highlight it, and hit DELETE to
  185. remove it.
  186.  
  187.  8. Press <Insert>
  188.  
  189.  9. Press <F3> to install the files in NIP318.
  190.  The "SPECIFY DIRECTORY PATH" dialogue box will appear.
  191.  
  192.  10. Type in the path to the directory where the NIP318 files
  193. were extracted.  Example:   SYS:\NIP318\NWIP1 <Enter>
  194.  
  195.  11. If previous patches remain, the NIP318 install will prompt
  196. you to remove them before proceeding.
  197.  
  198.  After the installation program installs the files, the
  199. "Currently Installed
  200.  Products" menu will appear listing:
  201.     NWIP     1.1     NetWare/IP
  202.     NWUPD    1.1C    PTF-F318 NetWare/IP Patch
  203.  
  204.  12. Exit the Installation program or press <ALT>+<ESC>.
  205.  The system console prompt will appear.
  206.  
  207.  13. Although your current NetWare/IP client will continue to
  208. work after you apply NIP318, we strongly recommend that you also
  209. update your NetWare/IP client by downloading NIPW21.EXE (it will
  210. be in the same Library as NIP318.EXE).
  211.  The IP Client in NIPW21.EXE provides: 
  212.  --- better IPX compatibility.
  213.  --- support for the NMS NET Explorer Automatic Discovery
  214. function.
  215.  --- support for the NWIPMAP.EXE included in NIP318.
  216.  --- support for other new features included in NIP318.
  217.  
  218.  14. If a NWIP server is a non - forwarding gateway, it does not
  219. send information learned from the IPX side to the DSS.  We
  220. encourage you to designate one or two NWIP/IPX servers as
  221. forwarding gateways and avoid having other servers as gateways
  222. (forwarding or non-forwarding), with no gateways configured as
  223. non - forwarding. 
  224.  
  225.  A NetWare/IP client, connected to a non-forwarding gateway, may
  226. be able to see a server using "SLIST" and yet not be able to
  227. connect to that server.
  228.  
  229.  NIP318 gives you the ability to set up "Forwarding NWIP/IPX
  230. Gateways" but, the default is non-forwarding.
  231.  
  232.  To configure the "Forward IPX to DSS" parameter on a NetWare/IP
  233. server, use the UNICON utility.
  234.  
  235.  Start at the UNICON utility's Main Menu and select the
  236. following:
  237.  -> Manage Services
  238.  ----> NetWare/IP
  239.  -------> Configure NetWare/IP
  240.  
  241.  The NetWare/IP Server Configuration screen will appear:
  242.  EXAMPLE
  243.  |NetWare/IP Domain:               nwip.novell.com|
  244.  |Preferred DSSes:                 <see form>     |
  245.  |Initial DSS Contact Retries:     3              |
  246.  |Retry Interval:                  4 seconds      |
  247.  |Slow Link Customization:         <see form>     |
  248.  |Forward IPX Information to DSS?  No             |
  249.  
  250.  Select the "Forward IPX Information to DSS?" field, and specify
  251. your selection.
  252.  
  253.  If you changed a parameter, return to the console prompt and
  254. type: 
  255.  UNISTOP <Enter>  to unload the NetWare/IP modules from memory.
  256.  
  257.  Then Type:  UNISTART <Enter>  to start the modules again.
  258.  
  259.  NOTE:
  260.  a) Forwarding cannot be changed dynamically. 
  261.  The command-line option /forward=yes (or /forward=no) can be
  262. used only at load time (not at run-time).
  263.  
  264.  AND
  265.  
  266.  b) Forwarding specification on the command line always overrides
  267. the forwarding specification in the NWPARAMS file.
  268.  
  269.  c) When NWIP is loaded with the option "/forward=no" for the
  270. first time, it can be loaded again with the option "forward=yes",
  271. and it will dynamically change to a forwarding gateway, but not
  272. vise versa.  If you want to change the forwarding gateway to a
  273. non-forwarding gateway, you have to unload and reload the NWIP
  274. again.
  275.  
  276.  The forwarding feature can be enabled(disabled) either by
  277. specifying a command line switch at load time or through UNICON
  278. under the configure NetWare/IP server option.
  279.  
  280.  
  281.  15. NetWare/IP Server Configuration
  282.  -----------------------------------
  283.  If you download NIPW21.EXE for your clients, and wish to
  284. configure the server to utilize the new parameters which will be
  285. available if you do, start the UNICON utility.  AFTER you finish
  286. changing parameters, return to the console prompt and type: 
  287. UNISTOP <Enter> 
  288.  to unload the NetWare/IP modules from memory.
  289.  
  290.  Then Type:  UNISTART <Enter>  to start the modules again.
  291.  
  292.  15A. To Configure the "Initial DSS Contact Retries" Parameter
  293.  At the main UNICON screen select:
  294.  -> Manage Services
  295.  ----> NetWare/IP
  296.  -------> Configure NetWare/IP
  297.  
  298.  The NetWare/IP Server Configuration screen will appear:
  299.  EXAMPLE
  300.  |NetWare/IP Domain:               NWIP.NOVELL.COM|
  301.  |Preferred DSSes:                 <see form>     |
  302.  |Initial DSS Contact Retries:     3              |
  303.  |Retry Interval:                  4 seconds      |
  304.  |Slow Link Customization:         <see form>     |
  305.  |Forward IPX Information to DSS?  No             |
  306.  
  307.  Change the "Initial DSS Contact Retries" field to the desired
  308. number of retries. 
  309.  
  310.  
  311.  15B. To configure the "Retry Interval" parameter:
  312.  At the main UNICON screen select:
  313.  -> Manage Services
  314.  ----> NetWare/IP
  315.  -------> Configure NetWare/IP
  316.  
  317.  The NetWare/IP Server Configuration screen will appear:
  318.  EXAMPLE
  319.  |NetWare/IP Domain:               NWIP.NOVELL.COM|
  320.  |Preferred DSSes:                 <see form>     |
  321.  |Initial DSS Contact Retries:     3              |
  322.  |Retry Interval:                  4 seconds      |
  323.  |Slow Link Customization:         <see form>     |
  324.  |Forward IPX Information to DSS?  No             |
  325.  
  326.  
  327.  15C. To configure the "Preferred DSS" Parameter
  328.  At UNICON's Main Menu, select the following:
  329.  -> Manage Services
  330.  ----> NetWare/IP
  331.  -------> Configure NetWare/IP Server
  332.  ----------> Preferred DSSes:  
  333.  
  334.  The Preferred DSSes (Host/IP Address/Network) screen appears.
  335.  Hit ENTER and a form screen will appear for you to fill in.
  336.  EXAMPLE
  337.    Preferred DSS #1:   20.19.0.0
  338.    Preferred DSS #2:   120.5.1.1
  339.    Preferred DSS #3:   127.39.1.0
  340.    Preferred DSS #4:   128.0.0.0
  341.    Preferred DSS #5:   sanjose
  342.  
  343.  
  344.  15D. For a NetWare/IP domain configured to span WAN links, you
  345. can configure the "Tunable Parameters":
  346.  
  347.  --- For a NetWare IPX client that occasionally times out or
  348. disconnects while accessing remote servers
  349.  
  350.  --- To control the network traffic between DSS servers and
  351. NetWare/IP servers, and between the primary DSS server and
  352. secondary DSS servers
  353.  
  354.  --- To optimize an IPX client that occasionally times out or
  355. disconnects while accessing remote servers, you can configure the
  356. Ticks Between Nodes Tunable parameters. 
  357.  
  358.  These parameters specify the approximate one-way time for a
  359. packet to travel, in ticks, between two NetWare/IP nodes on the
  360. same IP subnetwork, same IP network, and different IP networks. 
  361.  A tick equals 1/18th second. 
  362.  
  363.  You can estimate the time for a packet to travel between nodes
  364. on the same subnetwork, same network, and different networks, by
  365. using the NetWare PING utility. 
  366.  To access the Ping utility, enter:   LOAD PING ip_address
  367.  at your system prompt.
  368.  
  369.  To change the "Tuneable Parameters", at UNICON's Main Menu,
  370. select:
  371.  -> Manage Services
  372.  ----> NetWare/IP
  373.  -------> Configure Primary DDS
  374.  ----------> Tunable Parameters
  375.  
  376.  The "Tunable Parameters" will screen.
  377.  EXAMPLE
  378.  |UDP Port Number for NetWare/IP Service:          43981 |
  379.  |DSS-NetWare/IP Server Synchronization Interval:  5     |
  380.  |Primary-Secondary DSS Synchronization Interval:  5     |
  381.  |Maximum UDP Retransmissions:                     3     |
  382.  |UDP Checksum?                                    No    |
  383.  |Ticks between Nodes on the Same IP Subnet:       2     |
  384.  |Ticks between Nodes on the Same IP Net:          4     |
  385.  |Ticks between Nodes on Different IP Nets:        6     |
  386.  
  387.  Configure the last three parameters on the list:
  388.    - Ticks between Nodes on the Same IP Subnet:
  389.    - Ticks between Nodes on the Same IP Net:
  390.    - Ticks between Nodes on Different IP Nets:
  391.  
  392.  The example shows the defaults, which in most cases are
  393. sufficient. 
  394.  
  395.  If modifying the Ticks Between Nodes Tunable parameters does not
  396. completely solve your timeout problems, you can configure the
  397. NetWare/IP servers for host/networks across slow WAN links from
  398. which they send and receive packets.  Specifically modify the
  399. tick values on the NetWare/IP servers that act as IPX/IP gateways
  400. and/or send and receive packets over slow WAN links.
  401.  
  402.  Specify a remote IP network/host address and the approximate
  403. one-way time (in ticks) to ping a remote host on the other side
  404. of the slow link using UNICON.
  405.  You can specify up to five network/host-tick pairs.
  406.  
  407.  Use the NetWare Ping utility to estimate the time for a packet
  408. to travel the slow links. 
  409.  To access the Ping utility, enter:   LOAD PING ip_address
  410.  at your system prompt.  Use the average the PING utility
  411. calculates.
  412.  
  413.  At UNICON's Main Menu, select the following:
  414.  -> Manage Services
  415.  --> NetWare/IP
  416.  -----> Configure Primary DDS
  417.  --------> Slow Link Customizations:
  418.  
  419.  A Remote Access Via Slow Links screen will appear.
  420.  EXAMPLE
  421.  |Network/Host IP Address        Tick Value     |
  422.  |atlanta                        2              |
  423.  |127.39.0.0                     20             |
  424.  |<none assigned>                <none assigned>|
  425.  |<none assigned>                <none assigned>|
  426.  |<none assigned>                <none assigned>|
  427.  
  428.  To optimize the network traffic between DSS servers and
  429. NetWare/IP servers, and between the primary DSS server and
  430. secondary DSS servers, you can modify the following Tunable
  431. parameters on the primary DSS server.
  432.  Using UNICON, access the "Tunable Parameters" screen, as
  433. previously
  434.  described, and modify the following:
  435.  
  436.  - "DSS-NetWare/IP Server Synchronization Interval", which
  437. specifies how often a NetWare/IP server queries a DSS server for
  438. updated information.  The default is five minutes.
  439.  
  440.  If you want the latency between the servers and their DSS
  441. servers to be small at the expense of extra local traffic,
  442. specify a smaller value for this parameter (particularly if your
  443. configuration gives each site its own DSS server).
  444.  
  445.  - "Primary-Secondary DSS Synchronization Interval", which
  446. specifies how often a secondary DSS server queries the primary
  447. DSS server for update information. 
  448.  The default is five minutes.
  449.  
  450.  If you reduce the traffic between the primary and the secondary
  451. DSS servers at the expense of higher DSS-DSS latency (if your
  452. configuration spreads DSS servers across WANs), specify a larger
  453. value for this parameter.
  454.  
  455.  16. Administrators will not ordinarily need to increase the
  456. maximum size of the packet queues maintained by DSS for storing
  457. SAP and RIP packets or, increase the maximum number of TCP
  458. connections. 
  459.  
  460.  However, the DSS.NLM in NIP318 allows you to configure those
  461. values by adding the following lines to the DSS section of the
  462. SYS:ETC\NWPARAMS file of any DSS server you wish to modify.
  463.  
  464.  - To increase the maximum size of UDP packets to be greater than
  465. the default of 64, add the line: 
  466.  MAX_UDP_PKTS <n1>
  467.  where <n1> is a decimal integer greater than 64.
  468.  
  469.  - To increase the maximum size of the packet queues to be
  470. greater than the default of 16, add the line:
  471.  MAX_TCP_CONNS <n2>
  472.  where <n2> is a decimal integer greater than 16.
  473.  
  474.  17. Registered/Unregistered DSS Servers
  475.  After you have applied both NIP318 and NIPW21 you have the
  476. option of either registering DSS servers (entering them in the
  477. DNS database) or not registering them.
  478.  
  479.  DSS Server Registered with DNS
  480.  A registered DSS server is visible to all NetWare/IP nodes
  481. through DNS.  Each registered DSS server has corresponding NS
  482. records in the DNS database, which identify it as a name server
  483. for the NetWare/IP domain.  When a NetWare/IP host queries DNS
  484. for the location of the nearest DSS server, DNS will only return
  485. a listing of registered DSS servers, because they are the only
  486. DSS servers it knows about.
  487.  
  488.  DSS Server Unregistered with DNS
  489.  A NetWare/IP node cannot locate an unregistered DSS server by
  490. issuing a DNS query.  Instead, the NetWare/IP node must be
  491. provided the name or address of the unregistered DSS server as
  492. part of its preferred DSS server listing. 
  493.  For example, you may want to designate a DSS server that is
  494. isolated from the rest of the NetWare/IP internetwork by a WAN
  495. link as an unregistered DSS server to prevent NetWare/IP servers
  496. from redirecting their queries to this DSS server when other
  497. closer DSS servers are busy or down.
  498.  
  499.  Using unregistered DSS servers can help in overcoming a
  500. deficiency of most DNS implementations -- a reply to a DNS query
  501. can not exceed 1.5K bytes.
  502.  
  503.  If there are more nameservers than a DNS packet can accommodate,
  504. all nameserver entries may not be returned in response to an NS
  505. query.  This deficiency of DNS implementations can be bypassed by
  506. using unregistered DSS servers.  An administrator can use an
  507. unregistered DSS to designate exactly which DSS server a
  508. NetWare/IP node should use.
  509.  This gives the administrator better control of DSS server
  510. utilization and load balancing.
  511.  
  512.  18. Using NetWare/IP with the NetWare Management System
  513.  --------------------------------------------------------
  514.  NIPW21 provides better IPX compatibility and support for the NMS
  515. NET Explorer Automatic Discovery function.
  516.  
  517.  The default value for NWIP1_1 COMPATIBILITY is set to "OFF" to
  518. enable the
  519.  automatic discovery function with NIP318 client installation.
  520.  
  521.    NWIP1_1 COMPATIBILITY OFF
  522.  
  523.  If you have a mixed NetWare/IP environment in which the servers
  524. have either NetWare/IP v1.1 or this update installed, set the
  525. value to ON and then
  526.  no automatic discovery.
  527.  
  528.  
  529.  
  530. -----------------------------------------------------------------
  531.  Any trademarks referenced in this document are the property of
  532. their
  533.  respective owners.  Consult your product manuals for complete
  534. trademark
  535.  information.
  536.  
  537. -----------------------------------------------------------------
  538.  
  539.